Purpose & Motivation

Resolves #3.

Gitleaks가 탐지하는 결과 중 템플릿 placeholder, 더미 값, 반복 문자, 저엔트로피 문자열 등 명백한 false-positive 노이즈를 LLM verifier 이전에 필터링합니다. 목적은 storage/write volume과 verifier 비용을 줄이고, report/evaluate 단계의 신호 품질을 높이는 것입니다.

Context

• docs/views/research-and-technical-decisions.md에 parser 단계 noise filter 결정을 문서화했습니다.
• src/security_scanner/scanners/gitleaks/filter.py에 noise classifier를 추가했습니다.
• parse_gitleaks_report()에서 map_gitleaks_item() 호출 전 raw Gitleaks item을 필터링합니다.
• ScanOptions.enable_noise_filter를 추가하고 manifest scan.enable_noise_filter에서 제어할 수 있게 했습니다.
• GitleaksScanner.scan()이 scan_options를 parser까지 전달하도록 연결했습니다.
• debug log에는 secret 값을 남기지 않고 rule/reason만 기록합니다.

Note

리뷰 시 특히 아래를 봐주세요.

• parser-level filtering이 raw evidence/store/verifier 흐름과 맞는지
• false-negative prevention pattern이 public-safe synthetic token shape만 사용하면서도 너무 permissive하지 않은지
• enable_noise_filter=False 경로가 parser/scanner/manifest에서 모두 작동하는지

검증:

• uv run pytest → 366 passed
• git diff --check → clean
• cr review --agent -t committed --base origin/main → minor test coverage finding 반영 완료

Dependency

• Closes False-positive 노이즈 필터(placeholder, low-entropy 값)의 소유 레이어 결정 #3

Checklist

• 이 PR에 포함된 Commit에는 Secret Value가 포함되지 않았음을 확인했습니다.